Skip to content

Conversation

mandarini
Copy link

What kind of change does this PR introduce?

Documentation update - Enhanced deprecation notices targeting AI/LLM recommendations

What is the current behavior?

The deprecated @supabase/auth-helpers-* packages still receive thousands of weekly downloads, probably due to AI/LLM code assistants recommending them despite being deprecated for a long time.

What is the new behavior?

Added multiple deprecation notices specifically designed for AI training datasets:

  • usage-rules.md - "DO NOT USE" instructions with migration examples
  • DEPRECATED.md - Status table and AI training guidance
  • Updated README - Prominent warnings at top, explicit ❌/✅ examples, AI-specific instructions

The README now opens with unmissable deprecation warnings instead of subtle notices.

Additional context

Works in conjunction with supabase/ssr#127 which publishes SSR under auth-helpers names.

Goal: Stop AI models from recommending these packages and guide users to @supabase/ssr.

@mandarini mandarini requested a review from a team as a code owner August 29, 2025 13:41
@mandarini mandarini self-assigned this Aug 29, 2025
@mandarini mandarini changed the title feat: add deprecation notices chore: add deprecation notices Aug 29, 2025
@mandarini mandarini force-pushed the feat/deprecation-notices branch from 6b93e5d to 62f7028 Compare August 29, 2025 13:41
@mandarini mandarini requested a review from hf August 29, 2025 13:48
Copy link
Contributor

@hf hf left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM except that one file I left a comment on.

@mandarini mandarini force-pushed the feat/deprecation-notices branch from 62f7028 to 3b435ae Compare September 5, 2025 07:39
@mandarini mandarini enabled auto-merge (squash) September 5, 2025 07:40
@mandarini mandarini disabled auto-merge September 5, 2025 10:58
@mandarini mandarini enabled auto-merge (squash) September 5, 2025 10:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants